biomassa.bd          package: nenhum        R Documentation


Clculo da biomassa de rvores da floresta atlntica 


Descrio:

A funo calcula a equao de biomassa de rvores de floresta de mata atlntica, a partir das 
circunferncias e alturas dos individuos vegetais localizados em um data.frame e difencia esses 
resultados para cada tipo de estgio de floresta (inicial e intermediria-tardia). Segundo as 
necessidades do usurio, tambm gera de forma opcional um grfico bsico de diagnstico (boxplot) 
e um modelo de regresso linear.


Uso:

biomassa.bd<-function(x,y,z,grafico=T) 


Argumentos:

x: varivel de classe numrica. Faz referncia a uma coluna com dados contida em um data.frame, 
os quais correspondem a medidas de circunferncia das rvores em formato centmetro (cm).  

y: varivel de classe numrica. Faz referncia a uma coluna com dados contida em um data.frame, 
os quais correspondem a medidas de altura das rvores em formato metros (m).  

z: varivel de classe factor. Faz referncia a outra coluna contida em um data.frame, cujos 
valores correspondem a um tipo de estgio de floresta.

grafico: base para gerao de grfico. No caso (TRUE) gerar um boxplot e o modelo de regresso 
linear, se (FALSE) no gerar os grficos.


Detalhes:

Para que os clculos das equaes e a gerao dos grficos sejam realizados corretamente, o 
preenchimento dos dados no data.frame devero seguir as seguintes pautas:

-O data.frame deve apresentar valores em todas as linhas. Se houvesse presncia de NAs, a funo
no se efetua.

-A coluna com os valores que apresentem as categorias dos estagios sucessionais ter que estar 
nomeada como "estagios" na planilha que ser importada ao software R.
     
Como parte do resultado, a funo retornar um data.frame com as variveis na seguinte ordem: 
"Estagios", "Circunferencia", "Altura", "DAP", "Biomassa".


Valor:

Se grafico=T, a funo gera um grfico boxplot que analisa a biomassa para cada tipo de estgio de 
floresta e um modelo de regresso linear que relaciona o DAP calculado com a altura para cada 
indivduo vegetativo e retorna um data.frame com duas colunas adicionadas, resultado dos clculos 
das equaes. Se grfico=F, a funo retornar apenas o data.frame. As duas colunas a ser adicionadas 
correspondem a: 

	DAP		resultado da equao do DAP na unidade (cm): DAP = circunferncia/pi 

	Biomassa	resultado da equao proposta por Burger & Delitti (2008) nas unidades 
			(Mg/hectare) para calcular a biomassa de rvores na floresta de mata 
                        atlntica: LnDW = -3.676+0.951Lnd^2h


Avisos:

A funo  interrompida quando os argumentos "x" e "y" no so da classe numrica e/ou o argumento 
"z" da classe factor. Quando a funo gera o data.frame, retornar o aviso de se os grficos so 
ou no gerados, dependendo da opo do argumento "grfico" que o usuario escolheu.
Os clculos das equaes DAP e Biomassa so realizados independientemente da quantidade de parmetros 
disponveis no data.frame, mas o usurio deve adequar as colunas que corresponderiam aos argumentos 
"x", "y" e "z" na planilha antes de import-la para o software R. 
Para que o clculo seja realizado corretamente, o argumento "x" ter que corresponder na planilha  
coluna dos dados referente  circunferncia em formato cm, o argumento "y" corresponder  coluna da 
altura em metros e, o argumento "z",  coluna das categorias dos estgios sucessionais da floresta em 
estudo. 
A funo realizar a transformao da escala mtrica do resultado da Biomassa de kg por metro 
cuadrado diretamente a Mg por hectare, como recomendado por Burger & Delitti (2008).


Autora:

   Susana Lpez Caracena - Instituto de Biocincias USP
   selc@usp.br


Referncias:

-Burger, D.M. & Delitti, W.B.C. 2008. Modelos alomtricos para estimativa de fitomassa de Floresta 
Atlntica secundria no sudeste do Brasil. Biota Neotrop., 8(4)


Exemplo 1:

dados<-read.csv("dados_fun.csv", sep=";",dec=",")  #Importa-se a planilha exemplo "dados"
x<-dados$circunferencia  #Objeto x recebe os valores que correspondem  coluna dos dados da circunferncia 
(cm) da planilha exemplo "dados"
y<-dados$altura #Objeto y recebe os valores que correspondem  coluna dos dados da altura (m) da planilha 
z<-dados$estagios #Objeto z recebe as categorias que correspondem  coluna dos estgios sucessionais da 
floresta em estudo da planilha 
biomassa.bd(dados$circunferencia,dados$altura, dados$estagios, grafico="T") #Testa-se a funo, indicando 
a opo de retorno do fataframe com grficos

Exemplo 2:

dados<-read.csv("dados_fun.csv", sep=";",dec=",")
x<-dados$circunferencia 
y<-dados$altura 
z<-dados$estagios 
biomassa.bd(dados$circunferencia,dados$altura, dados$estagios, grafico="F") #Testa-se a funo, indicando 
a opo de retorno do fataframe sem grficos.